home *** CD-ROM | disk | FTP | other *** search
/ Java Programmer's Toolkit / Java Programmer's Toolkit.iso / hotjava / classsrc / java / util / condit~1.jav < prev    next >
Encoding:
Text File  |  1995-08-11  |  2.2 KB  |  74 lines
  1. /*
  2.  * @(#)ConditionLock.java    1.7 95/01/31  
  3.  *
  4.  * Copyright (c) 1994 Sun Microsystems, Inc. All Rights Reserved.
  5.  *
  6.  * Permission to use, copy, modify, and distribute this software
  7.  * and its documentation for NON-COMMERCIAL purposes and without
  8.  * fee is hereby granted provided that this copyright notice
  9.  * appears in all copies. Please refer to the file "copyright.html"
  10.  * for further important copyright and licensing information.
  11.  *
  12.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  13.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  14.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  15.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  16.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  17.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  18.  */
  19.  
  20. package java.util;
  21.  
  22. /**
  23.  * ConditionLock is a Lock with a built in state variable.  This class
  24.  * provides the ability to wait for the state variable to be set to a
  25.  * desired value and then acquire the lock.<p>
  26.  *
  27.  * The lockWhen() and unlockWith() methods can be safely intermixed
  28.  * with the lock() and unlock() methods. However if there is a thread
  29.  * waiting for the state variable to become a particular value and you
  30.  * simply call Unlock(), that thread will not be able to acquire the
  31.  * lock until the state variable equals its desired value. <p>
  32.  *
  33.  * @version     1.7, 31 Jan 1995
  34.  * @author     Peter King
  35.  */
  36. public final
  37. class ConditionLock extends Lock {
  38.     private int state = 0;
  39.  
  40.     /**
  41.      * Creates a ConditionLock.
  42.      */
  43.     public ConditionLock () {
  44.     }
  45.  
  46.     /**
  47.      * Creates a ConditionLock in an initialState.
  48.      */
  49.     public ConditionLock (int initialState) {
  50.     state = initialState;
  51.     }
  52.  
  53.     /**
  54.      * Acquires the lock when the state variable equals the desired
  55.      * state.
  56.      * @param desiredState the desired state
  57.      */
  58.     public synchronized void lockWhen(int desiredState) {
  59.     while (state != desiredState) {
  60.         wait();
  61.     }
  62.     lock();
  63.     }
  64.  
  65.     /**
  66.      * Releases the lock, and sets the state to a new value.
  67.      * @param newState the new state
  68.      */
  69.     public synchronized void unlockWith(int newState) {
  70.     state = newState;
  71.     unlock();
  72.     }
  73. }
  74.